OS/2 TCPIP 
CONFIGURATION 
(TCPCFG.EXE) 



Mike Rutherford 

T/L 444-4848 
mike @ rtpnotes 
mike@raleigh.ibm.com 




Overview 



Description 

/Provides the ability to configure 
major components of TCP/IP for 


OS/2 










Overview - Features 



Network Tab 
Amptn\bin\setup.cmd 
/etc\dhcpcd.cfg 
/OS/2 System startup folder 

Routing Tab 

Amptn\bin\setup.cmd 

Hostnames Tab 
Aconfig.sys 
Aetc\resolv2 
Aetc\hosts 
Aconfig.sys 

Autostart Tab 

Atcpip\bin\tcpstart.cmd 

General Tab 

Aconfig.sys 










Overview - Features 
(continued) 



•Security Tab 
Aconfig.sys 
Aetc\trusers 
Aetc\rhosts 
Aetc\tftpauth 

•Servers Tab 

Aetc\tcpos2.ini 

•Socks Tab 
Aetc\socks.env 
Aetc\socks.cfg 

•Printing Tab 
Aconfig.sys 
Aos2\os2.ini 
Aos2\os2sys.ini 

•Mail Tab 

Aetc\tcpos2.ini 

AetcYAmailstor directory moved 










Overview - Features 
(continued) 



•Sendmail Tab 
Aetc\sendmail.cf 
/\etc\sendmail.uml 
Aetc\tcpos2.ini 










Features new with 
Merlin 



•SOCKS Tab 
/3 pages 

-page 1 writes configuration data 
to socks.env 

-pages 2 & 3 write configuration 
data to socks.cfg 

•Variable subnet routing 
/one field added to Routing page 

-Subnet mask can be entered for 
all routes except default route 










Limitations 

Dependencies 



•must have a dll present in order for 
tab to appear 

•must have all corresponding help 
(\tcpip\help\cnb*.hlp) files present for 
each dll (\tcpip\dll\cnb*.dll) in order 
for any help to work 




Installation 



The following executable 

configuration files are installed: 

ztcpcfg.exe 
/cn bdns.dll 
/cn bgen.dll 
/cnbiak.dll 
/cnbprt.dll 
/cn bserv.dll 
/cn bsmail.dll 
/cn bsocks.dll 
/cn bstk.dll 

...along with the following help files: 
/tcpipcfg.hlp 
/cnbdns.hlp 
/cnbgen.hlp 
/cnbiak.hlp 
/cnbprt.hlp 
/cnbserv.hlp 
/cnbsmail.hlp 
/chbsocks.hlp 
/chbstk.hlp 




Configuration & Setup 


•Installation program places: 
ztcpcfg.exe in \tcpip\bin 
/all cnb*.dll in \tcpip\dll 
/all cnb*.hlp in \tcpip\help 
/tcpipcfg.hlp in \tcpip\help 

•tcpcfg.exe must be in a directory 
specified in the PATH= statement in 
CONFIG.SYS 

•cnb*.dll files must be in a directory 
specified in the LIBPATH= statement 
in CONFIG.SYS 

•cnb*.hlp files must be in a directory 
specified in the HELP= statement in 
CONFIG.SYS 




Invocation & Startup 



To start the configuration notebook: 

/dick on the TCP/IP Configuration 
(LAN) icon located in the Internet 
(LAN) folder 

/type tcpcfg on an OS/2 command 
line (window or fullscreen) 





Error Messages, Codes 
& Logs 


•all error/informational messages are 
displayed in popup boxes 

/messages extracted from country's 
message files, e.g.: 

-enus\cnb*.msg 

-dede\cnb*.msg 

-etc... 

/some error checking done at the 
entry field level 

/some error checking done at the 
page level 

/some error checking done when 
program is closed 

/action to take 

•Error log generated when the 
configuration notebook is started with 
-d option 

ztcpcfg -d 

/generally stated from the command 
line as opposed to from the icon 

/log is generated in the directory 
where tcpcfg was started 




Common User 
Problems 



•Help not available 

/each *.dll must have an 
accompanying *.hlp file 

•TABS missing from config notebook 
/dll is missing/corrupted 
•notebook will not start 

/probably due to backlevel 
tcpcfg.exe 

-2.0 CSD placed on top of 
Merlin?? 





Debugging & 
Troubleshooting 


•A log file of configuration transactions 
can be created by invoking tcpcfg 
with the -d option, e.g.: 

/tcpcfg -d 

/the file (tcpcfg.log) will be created 
and placed in the directory from 
which tcpcfg was started. 

•Debugging info: 

/depending on what type of problem 
the user is having, any of the files 
listed under "Features" could be 
useful. 




Source Overview 



•All source code in CMVC 
/family: wstcp 
/release: os2apps32 
/components: 


-os2tcpcfg: 

: driver (tcpcfg.exe) which starts 

the notebook 


-os2cnbdns 
: Hostnames Tab 

-os2cnbgen 

: Autostart & General Tabs 

-os2cnbiak 
: Servers Tab 

-os2cnbmail 
: Mail Tab 

-os2cnbprt 
: Printing Tab 



Source Overview 
(continued) 



-os2cnbserv 
: Security Tab 

-os2cnbsmail 
: Sendmail Tab 

-os2cnbstk 

: Network & Routing Tabs 

-os2cnbsocks 
: Socks Tab 



